home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / viewers / oyviewer.lzh / VIEWER.DOC next >
Text File  |  1993-06-26  |  20KB  |  408 lines
  1.  
  2.                     OH YEAH!  FILE VIEWER v0.9
  3.                     --------------------------
  4.  
  5.  
  6.             INTRODUCTION ("What is it?")
  7.             ----------------------------
  8.  
  9.     I'm sure you've all used a file viewer at one time or another.   Basically,
  10. in a word,  put simply for your average layman to understand,  a  file  viewer,
  11. right, is a program, ok, that lets you VIEW ... FILES! :]
  12.  
  13.       The  simplest  example  is   the   desktop   'show'   option   from   the
  14. 'show/print/cancel'  box that comes up when you double click on  a  non-program
  15. file.  If you've ever made much use of this you'll know that, whilst very handy
  16. for taking a quick look at bog-standard text files,  it's almost useless if you
  17. want to examine a document in detail, or examine other sorts of files.
  18.  
  19.     Another popular viewer is 'more',  originally from UNIX and now popping  up
  20. almost everywhere.  This is a little more useful:  you  can  go  backwards  and
  21. forwards through the file by pages or lines, and even search for strings in the
  22. file,  which can all be very handy.  But it was  originally  written  for  dumb
  23. terminals, which could only print at the bottom of the screen and scroll it up.
  24.  
  25.     A more sophisticated program for the ST  series  is  the  Revenge  Document
  26. Displayer from the Hitchhiker. This uses the full graphics capability of the ST
  27. to provide line-by-line scrolling in both directions, some printing options and
  28. even pictures while you're  waiting!   I  like  this  one,   but  it  has  some
  29. annoying features. And so I wrote my own...
  30.  
  31.     So,  here's *yet* *another* File Viewer:  hopefully it's  the  (only)   one
  32. you'll need from now on!
  33.  
  34.  
  35.  
  36.             FEATURES ("Wow, it does *this*!")
  37.             ---------------------------------
  38.  
  39.     * Any type of file (Atari, Mac, UNIX,...)
  40.  
  41.     * Show as ASCII, graphics, or hex dump
  42.  
  43.     * Variable tabstops
  44.  
  45.     * Long lines wrapped or scrolled
  46.  
  47.     * Fast up/down scrolling
  48.  
  49.     * Compatible with medium rez, high rez, big screens, Moniterm, etc etc
  50.  
  51.     * File information shown: size, word count, type,...
  52.  
  53.     * All 256 ASCII and graphics characters are supported.
  54.  
  55.     * Search for string (case in/sensitive)
  56.  
  57.     * Different character sizes
  58.  
  59.     * Very big files no problem
  60.  
  61.     * Simple user interface (keyboard/mouse driven with menu)
  62.  
  63.  
  64.             WARNING ("It's *almost* finished!")
  65.             -----------------------------------
  66.  
  67.     This version is v0.9:  it's not *quite* finished yet.  I've been working on
  68. it for over a year now,  but I'm leaving college in 3 days  and  after  that  I
  69. won't have access to the Internet any more :-(((((( so I'm afraid I've  had  to
  70. post this 'as is'.  I'm sure you'd prefer this version (which works fine  apart
  71. from two minor points)  to no version at all!!!  If you contact me,  I can send
  72. you the finished version, if it's ready (see below).  The main problems are low
  73. rez (going into medium rez temporarily is fine,  but it comes out as yellow  on
  74. white which is unreadable!  I haven't time just now to sort out  the  palette),
  75. and the Search option (it works fine, but the area highlighted isn't always the
  76. string found: it doesn't yet take into account tabs etc.)  Also files with more
  77. than 32768 lines could cause problems,  but that's unlikely:  I've viewed files
  78. over 300k before without ever approaching the limit.
  79.  
  80.  
  81.             USAGE ("What do I do?")
  82.             -----------------------
  83.  
  84.     The easiest way to use the Oh Yeah!  File Viewer is to install  it  on  the
  85. desktop as the default application for all files:  click  once  on  VIEWER.PRG,
  86. then select Install Application,  and enter *.* for the file type.  After that,
  87. whenever you double-click on a file that's not a program,  it  will  be  loaded
  88. into the Viewer.  (You should make sure that VIEWER.PRG is  always  accessible,
  89. eg.  on a hard disk or ramdisk)  This is safe no matter what type of  file  you
  90. click on:  if it's not plain text,  you just won't get plain text on screen.
  91.  
  92.     Alternatively,  if you have a replacement desktop that lets  you  put  file
  93. icons onto the desktop, you can drag files onto the VIEWER.PRG icon.  This way,
  94. you can examine program files as well.
  95.  
  96.     You may be able to give it a TTP extension,  and type in the  name  of  the
  97. file to view, or use Double Click's Gem-Takes-Parameters utility.
  98.  
  99.  
  100.     Go ahead, try it now! Load this file up and see what happens!  Quick guide:
  101. use the mouse to scroll the file, right button exits,  left button calls up the
  102. menu (only one!) and right button leaves it. The rest should be obvious!
  103.  
  104.     When you run Oh Yeah!  File Viewer,  what you see is your file  on  screen,
  105. with a header bar at the top.  This tells you what program you're  running  (Oh
  106. Yeah!  File Viewer, of course!), which version,  what file you're viewing,  how
  107. many lines it has,  and what line you're currently on (the number  of  the  top
  108. line). To start with this is always line 1. How many lines are shown depends on
  109. the screen mode: it's usually 24.
  110.  
  111.     You can scroll through the file, if it's too big for the screen,  simply by
  112. moving the mouse up or down.  It's as simple as that!   The  file  follows  the
  113. mouse: move it up and the file follows, stop and it does too.  You can also use
  114. keys to move up or down:  the up and down arrow keys move up and  down  by  one
  115. line.  Space moves down by one screenful,  'B' moves up.  'S' takes you to  the
  116. start of the file, 'E' to the end.  When you've finished and want to leave, you
  117. can press 'ESCAPE', 'Q', 'UNDO', or the right mouse button.
  118.  
  119.     As you can see,  Oh Yeah!  File Viewer was designed to be quick and easy to
  120. use. No more tedious file selectors, no more menus to wade through or dialogues
  121. to click on, just simply to view a file.  You go straight to the file, and then
  122. straight back to the desktop again.  If VIEWER.PRG  is  stored  in  a  ramdisk,
  123. viewing files becomes incredibly quick.
  124.  
  125.     Oh Yeah! File Viewer (I sound like a salesman, don't I?  I should have used
  126. a shorter name!  :) also lets you do more sophisticated things,  though.  Press
  127. the left mouse button to call up the menu. The options are:
  128.  
  129.  
  130.     GOTO START:     self-explanatory
  131.  
  132.     GOTO END:        "        "
  133.  
  134.     GOTO LINE:       "        "
  135.  
  136.  
  137.     FORMAT:
  138.             This lets you choose how you want the file formatted. You can have:
  139.         ASCII: Only the standard  ASCII  characters  are  shown  (the  letters,
  140.                numbers, symbols etc, but not characters with codes <32 or >127)
  141.                Tabs, backspaces, etc are interpreted.
  142.         GRAPHIC: All characters are shown,  none  are  interpreted.  Characters
  143.                  with codes < 32 or > 126  are  shown  as  graphic  characters.
  144.                  (code 0, NULL,  is shown as a '.').
  145.         HEX: The hex(adecimal)  values of the characters are shown,  along with
  146.              their graphic characters.  A number on the lefthand side shows the
  147.              position in the file, also in hex.
  148.  
  149.     TABS:
  150.             This is only applicable to the ASCII format. Here you can alter the
  151.             number of spaces between tabstops.  Each tab character advances  to
  152.             the next tabstop.
  153.  
  154.     WRAP:
  155.             This sets whether lines that  are  too  wide  for  the  screen  are
  156.             wrapped onto the next line,  or  whether  the  screen  is  scrolled
  157.             sideways. Scroll using the left and right arrows, or move the mouse
  158.             sideways.
  159.  
  160.     SMALL FONT:
  161.             Two character sizes are supported,  large  and  (not  surprisingly)
  162.             small.  The default is large for monochrome monitors, and small for
  163.             colour. (Large is twice the height of small; the both have the same
  164.             width).
  165.  
  166.  
  167.     FIND STRING:
  168.             Enter a string in the box,  and its first occurrence  in  the  file
  169.             will be shown.   No wildcards are supported (so far :)  If the Case
  170.             Sensitive option is selected,  the  string  must  match  *exactly*,
  171.             otherwise  capital and little letters are treated the